home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / shells / tcsh602.zoo / tcsh602 / README.ST < prev    next >
Encoding:
Text File  |  1993-02-23  |  5.8 KB  |  137 lines
  1. This is my (Michael Hohmuth's) port of tcsh 6.02.00 to MiNT (_not_ TOS).
  2.  
  3. This file only describes the special features of the MiNT version.  For 
  4. documentation refer to the manual pages.
  5.  
  6. Manifest:
  7.  
  8.         FAQ             - Frequently Asked Questions about tcsh
  9.         Fixes           - what has been fixed since the last version of tcsh
  10.         NewThings       - what's new in this version of tcsh
  11.         README          - original README from the tcsh distribution
  12.         README.ST       - this file
  13.         complete.tcsh   - examples on how to use tcsh's completition feature
  14.         csh.1           - csh manual
  15.         csh.man         - csh manual in roff format
  16.         diffs           - context diffs for tcsh for MiNT
  17.         tcsh.1          - tcsh manual
  18.         tcsh.man        - tcsh manual in roff format
  19.         tcsh.ttp        - tcsh binary for MiNT
  20.  
  21. Special features of the MiNT version:
  22.  
  23.         o   The version of `tcsh.ttp' in this distribution has been 
  24.             configured to support DOS file systems in the following two 
  25.             aspects:
  26.  
  27.             (1) tcsh's builtins support DOS file names with drive 
  28.                 specifications and backslashes. However, note that you 
  29.                 have to escape backslashes with another backslash: "\\"
  30.  
  31.             (2) tcsh uses DOS compatible file names for its 
  32.                 configuration files:
  33.  
  34.                 UNIX file name      DOS file name
  35.  
  36.                 .history            history.csh
  37.                 .cshdirs            cshdirs.csh
  38.                 .tcshrc             tcshrc.csh
  39.                 .cshrc              cshrc.csh
  40.                 .login              login.csh
  41.                 .logout             logout.csh
  42.                 /etc/csh.cshrc      /etc/cshrc.csh
  43.                 /etc/csh.login      /etc/login.csh
  44.                 /etc/csh.logout     /etc/logout.csh
  45.  
  46.         o   This version of `tcsh.ttp' also has been configured to strip 
  47.             CRs (0x0d) from line endings.
  48.  
  49.         o   The MiNT version of tcsh supports a list of suffixes which 
  50.             executable files can have.  This list is initially taken 
  51.             from the environment variable "SUFFIXES"; if this variable 
  52.             does not exist, it defaults to "ttp,prg,tos,app,gtp,csh,".
  53.  
  54.         o   `tcsh.ttp' has been linked with the MiNT Library PatchLevel 
  55.             pre-28.  That means that it has the following additional 
  56.             feature:
  57.  
  58.             All environment variables which are listed in the environment 
  59.             variable "PATHCONV" will be converted from a DOS style path 
  60.             list to a Unix style one.  If "PATHCONV" does not exist, it 
  61.             defaults to "PATH".  Please note that setting PATHCONV from
  62.             inside tcsh has no effect on the other environment variables
  63.             (except when spawning, when the variables will be converted
  64.             back to TOS style).  So make sure that PATHCONV has been
  65.             initialized before you enter tcsh (e.g. set in in your mint.cnf 
  66.             file).
  67.  
  68.             I suggest you use at least the following setup for "PATHCONV": 
  69.             "PATH,HOME,SHELL".
  70.  
  71.         o   The "autolock" feature work exactly like "autologout", because
  72.             the MiNT library doesn't support password encryption.
  73.  
  74.         o   `tcsh.ttp' has been compiled with GCC 2.3.3 pl 1 and the
  75.             "-mbaserel" option so that it is sharable under MiNT.
  76.  
  77. Credits:
  78.  
  79.         This port is mainly based on Eric Smith's port of tcsh 6.00.02 
  80.         to MiNT.  I just straightforwardly applied Eric's changes, fixed 
  81.         a few bugs, added a few features (and removed some) and added 
  82.         support for 6.02.  (For a list of differences from Eric's 
  83.         port, see below.)  Thanks, Eric!
  84.  
  85. Enjoy!
  86.  
  87. 22 Feb 1993
  88.  
  89. Michael Hohmuth
  90.  
  91. hohmuth@freia.inf.tu-dresden.de
  92. mh1@irz.inf.tu-dresden.de
  93.  
  94.  
  95. --------------------------------------------------------------------------
  96.  
  97. APPENDIX
  98.  
  99. Differences from Eric Smith's port of tcsh 6.00.02:
  100.  
  101.         o   My port does not support the shell variables "escchar" and 
  102.             "dosslashes".  That means that it's not possible to redefine 
  103.             the shell's escape character and use single backslashes as 
  104.             path separators (use escaped backslashes instead), and the 
  105.             shell always outputs "/" as the path separator.
  106.  
  107.         o   Eric renamed the file `.cshrc' to `csh.rc'.  I named it 
  108.             `cshrc.csh' because this seemed more logical to me.
  109.  
  110. If you want to re-compile tcsh for MiNT:
  111.  
  112.         You can only build tcsh on a non-TOS file system.  Also, you 
  113.         need good versions of `sh', `egrep', and `sed', which are used 
  114.         during the build process.  (If you're cross-compiling on a Unix
  115.         host, this should not be a problem.)
  116.  
  117.         You have to get `tcsh-6.02.00.tar.Z' and apply to it the patches in 
  118.         the file `diffs' from this distribution.
  119.  
  120.         Edit the `Makefile' to suit your taste.
  121.  
  122.         You might also want to have a look at `config_f.h', where 
  123.         several features can be turned on or off.  The MiNT version has 
  124.         these additional features, which are turned on by default:
  125.  
  126.         o   If you define DOSFS, tcsh's builtins will support DOS file 
  127.             names with drive specifications (like "a:") and backslashes 
  128.             (which have to be escaped, like "\\").  Also, tcsh will use 
  129.             DOS compatible names for its configuration files   
  130.             (`login.csh' instead of `.login', for instance; see above 
  131.             for a complete list of affected file names).
  132.  
  133.         o   If you define DOSTEXT, tcsh will try to strip CRs from line 
  134.             endings in text files.  This will allow you to use scripts 
  135.             which have DOS line endings in them.
  136.  
  137.